home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
comm
/
byepc300.zip
/
BYE-PC.DOC
< prev
next >
Wrap
Text File
|
1987-01-03
|
48KB
|
1,590 lines
BYE-PC Resident Modem Driver
with
DOS Interface
Manual Version 1.0 - February, 1987
This document describes the operation of BYE-PC and the
application interfaces required to access functions that control
modem operations. It is not intended as a reference to 8086
assembly language or the 'C' programming language, but serves to
provide a description of the operation and uses of BYE-PC.
by
MCODE Software
3444 Dresden Drive
Montgomery, Alabama, 36111
(205)244-7230
Copyright (C) 1986, 1987 MCODE Software
All of the source code is copyrighted material by MCODE
Software. The author retains all rights to the source code
provided in this package. This code may not be distributed in any
modified form without written or verbal consent from the author.
Any form of sale other than MCODE Software is prohibited. This
software may not be offered for sale by any means or form to
others without written permission from MCODE Software.
DISCLAIMER
The author has taken great care to insure that this manual
and associated software provide accurate information in regards
to the documentation and source code provided. Any references to
particular compilers, linkers or other development tools are
believed to be true by the author. No warranty is made regarding
the fitness or validity of such material for any circumstance.
Hardware and software compatibility is not guaranteed for any
particular types of machines other than those mentioned in this
manual. This software has been tested extensively under specific
operating environments and is believed to operate as described
within this manual. In no event will MCODE software or the
authors be held liable for damages of any kind, in regard to or
arising from the use of accompanying software or and documenta
tion. No representation to the suitablity for this product for
any use is made by the author.
BYE-PC is a Tradmark of MCODE Software. IBM, IBM PC, PC XT,
PC AT, DOS and PCDOS are Tradmarks of International Business
Machines Corp. Microsoft C, MSDOS, ASM, and MASM are Tradmarks
of Microsoft Corp. Hayes, Smartmodem, Smartmodem 300, Smartmodem
1200 are trademarks of Hayes Microcomputer Products Inc. CP/M is
a tradmark of the Digital Research Corp.
TABLE OF CONTENTS
Introduction.........................................
Compiler Information.................................
Configuring BYE-PC for your system...................
BYE-PC Program Structure.............................
Interface to application programs....................
Caller status word...................................
Getting Started......................................
Program Operating structure..........................
Interface functions..................................
Compiling BYE.ASM Source Code........................
Telebit Trailblazer(tm) 9600bps high speed modem.....
.PA
INTRODUCTION
Welcome to BYE-PC! Your support is greatly appreciated and
we sincerely thank you for using our product. It is our hope
that you will benifit and learn from the provided source code. If
you are an accomplished programmer and already understand the
operations of interrupt driven software, please send us your
comments, advice or any other suggestions concerning this
package. We hope that you will enjoy using this package as much
as we have in providing it. Contact us if you are having any
problems setting up the system and we will try to provide you
with an answer or solution. It is recommended that a $30.00
donation be made to the author if you use this program on a
regular basis. Registered users will receive technical support
only. PLEASE DON'T BOTHER TO CALL IF YOU ARE NOT A REGISTERED
USER!
MCODE Software will provide all registered users with
updates for an unlimited period of time. Users that request
updates will have to provide for any shipping and disk cost at a
very minimal fee. Also, we plan to keep the latest copies of BYE-
PC and related programs available for downloads at any time.
Please keep in touch with us via the Board Walk RBBS distribution
point in Montgomery, Alabama at (205)277-3882 or write to us at
MCODE Software. There are still many new features in the making
and we want you to receive the latest versions as soon as re
leased.
WHAT IS BYE-PC?
BYE-PC is a memory resident modem driver that is interrupt
driven to provide fast reliable serial communications with phone
modems. BYE-PC is a complete implementation of the BYE CP/M
version offered in the public domain for use on eight bit
systems. The CP/M implementation does not support rs232 driven
interrupts and is much slower than BYE-PC. BYE-PC allows for full
keyboard type ahead from the remote station. Characters may be
received during other processes without polling the receive port
for a data ready signal.
Please be sure and read the supplementary documentation
files that exsists. These files contain important information on
recent updates that may have occured:
READ.ME ---- Latest modifications
Any recent modifications that occur since the last manual publi
cation, are contained in the file READ.ME. Please read the copy
right notice and license agreement in the file COPYRGHT.BYE.
.PA
WHAT WILL BYE-PC DO?
An IBM PC, PC XT, or PC AT host computer running BYE-PC
allows a remote callers access to DOS. A series of interrupts are
overtaken and/or chained that patch the modem i/o signals into
the BIOS. Since DOS makes calls through the BIOS, almost any
program that does not access the serial port or screen directly
will run under BYE-PC. Although the large majority of programs do
not adhere to these rules, most programs that are well behaved
and write to 'stdin' and 'stdout' will run properly under BYE-PC.
For instance, DEBUG may run remotely to allow viewing the system
internally, or file archive utilities such as ARC, ZOO, etc...,
may be used.
Once a caller has established a connection, BYE-PC allows the
option to execute a .COM or .EXE file. This allows any number of
programs, such as bulletin boards, to receive control before
allowing users to enter DOS. Since any DOS commands may be exe
cuted while running BYE-PC, users have complete control. A
security shell is provided that parses all DOS commands prior to
execution by COMMAND.COM. This allows selective commands to check
internal status before execution to eliminate unwanted commands,
paths, drives or DOS functions.
Currently all application programs that provide access to
BYE-PC such as XMODEM, CHAT, STAT, and RBBS, are created using
the Microsoft C compiler. A standard interface is provided that
allows C programs direct control over the host system. An
application may disconnect, check status, or change values
within BYE-PC through an additional software interrupt. Assembly
language routines may call BYE-PC functions as easily as C
applications through the system control interrupt (SCI).
Since all data is received from hardware interrupts,
characters are stored in a buffer within BYE-PC as each interrupt
occurs. All requests for data are made through the SCI and the
provided C interface BYEXFACE.C. These topics are covered in
greater detail in the following sections of this manual. Hardware
interrupts occur with changes of state in the rs-232 serial
port card. I